home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / packet / terminal / simptr23 / readme < prev    next >
Encoding:
Text File  |  1996-02-04  |  9.4 KB  |  209 lines
  1. Welcome to SimpTerm 2.3, the tnc/tu communications package for the masses.
  2.  
  3. You should have the following after unzipping. 
  4.  
  5. amsoft.exe      54948   1-07-96  21:12   enqhelp.exe     67250   5-12-95  18:31
  6. keys.doc         1696  10-16-94  22:27   qrz.exe         24528   1-07-96  21:06
  7. readme           9534   2-04-96  13:25   setup.txt           3   2-04-96  12:17
  8. simp.cfg            8  11-24-94  13:37   simp.doc        84568   2-04-96  11:50
  9. simp.exe       230128   2-04-96  12:16   simp.hlp         1231   1-25-94  18:21
  10. simp.hlw         1899   8-12-93  20:34   simp.ini         2637   2-04-96  13:23
  11. simpmono.cfg        8   8-17-93  13:27   
  12.  
  13. The keys.doc file contains a list of the valid key names.
  14. The simp.doc is the main manual.  Copy it to your printer (36 pages)
  15. or read it with your favorite editor/lister or more.
  16. If you have a problem with the program's selection of colors on
  17. your mono monitor, copy simpmono.cfg to simp.cfg.  It should
  18. display a basic black and white screen.
  19.  
  20. Please at least read the quick start section of the manual before
  21. you attempt to use SimpTerm.
  22.  
  23. The size of the readme file probably won't match, but the rest should.
  24.  
  25. New features in SimpTerm 2.3
  26.  
  27. This verison detects when DesQView is present and will give up the
  28. cpu while waiting for keyboard and com port events.
  29.  
  30. I've added a feature that you can use to automate your conversations
  31. a bit.  If you have a mouse, you can click on the first character of a 
  32. call and it will copy that call to a buffer and display that call on the
  33. status line.  You can use that call in messages with the %C notation.
  34.  
  35. For instance, if you have a line in your .ini file that looks like:
  36. ALT_F12 %C de wz9xyz k^M
  37. When you press the ALT-F12 key, you will send the call that is displayed
  38. at the beginning of the status line followed by "de wz9xyz k".  To clear
  39. the call field, click (left mouse button) on a blank section of the screen.
  40.  
  41. Set the variable, MYCALL, to your call letters and you can substitute
  42. %L for your call, just like you can substitute the other station's call
  43. for %C as demonstrated in the previous paragraph.
  44.  
  45. Also, the program attempts to recognize calls as they are printed on the 
  46. screen and stores them in a buffer.  You can use the splat function to 
  47. display a menu of the last 20 calls.  Use your mouse or the arrow keys
  48. to select a call.  Press Enter or the left mouse button to select.
  49.  
  50. Again, to clear a call just select a blank area of the screen and click
  51. the left button.
  52.  
  53. You can now design your own menu bar.  Use the "BUTTON" keyword to define
  54. the menu buttons.  The format of the "BUTTON" line is:
  55.  
  56. BUTTON <tag> <macro>
  57.  
  58. Where tag is a name that will be displayed on the button (max of 8 characters)
  59. and the macro is what will be sent to the tnc when you select that button.
  60. You may have multiple BUTTONs in your .ini file.  See the sample simp.ini
  61. file for an example.  In that file I have defined buttons to select the 
  62. different modes for a PK-232.  
  63.  
  64. The DISPBUT function brings the menu up.  It automatically disappears after
  65. selection of one of the buttons.  Type an ESC character to remove it without
  66. selecting any button.
  67.  
  68. New features in SimpTerm 2.1
  69.  
  70. Added the following %c notation special formatting characters.
  71.  
  72. %Y    2 character year (00-99)
  73. %M    2 character month (01-12)
  74. %A    2 character day (1-31)
  75. %H    2 character hour (00-23)
  76. %m    2 character minute (00-59)
  77. %S    2 character second (00-59)
  78.  
  79. These can be used to form a date/time string "your way".
  80. You can now have something like:
  81. KEY_ALT_F9 This is kd4rqn at %H:%m:%S
  82. in your simp.ini file and when you press the alt-f9 key you will send
  83. This is kd4rqn at 23:59:59
  84. If you do it at one second before midnight.
  85.  
  86. The preload file is now searched for the special characters on a line-by-line
  87. basis.  This enables you to have something like:
  88. DAYTIME %Y%M%A%H%m
  89. in your ini file to set the date and time correctly on your TNC.  
  90. This works for any tnc that conforms to the TNC-2 standard.
  91.  
  92. Not mentioned before, but these date and time functions along with
  93. the original ones (%d, %D, %t) pay attention to the GMT variable.
  94.  
  95. You can now display the current date and time on the status line with
  96. the TIMELINE variable.  If you set the TIMELINE variable to a character
  97. string including the date and time functions as described above, the
  98. status line will display the date and time as you defined it.
  99. For example:
  100. TIMELINE %A-%M-%Y %H:%m:%S
  101. in your simp.ini file will cause the status line to include:
  102. 25-12-93 12:00:00
  103. At noon on Christmas, 1993, if you're lucky enough to be able to get on
  104. the air on Christmas.
  105.  
  106. There is a new variable, POSTLOAD, that works exactly like the PRELOAD
  107. variable, except it uploads the file just before exiting.  You can
  108. use this to leave your tnc in a known state after running SimpTerm.
  109.  
  110. There is a new function, savebuf, that will ask you for a file name
  111. and then dump the received data buffer to a file.  The received data
  112. buffer is what you are looking at as you scroll back in the top 
  113. window. 
  114. You might have something like:
  115. !KEY_ALT_S savebuf
  116. in your ini file and when you hit the alt-s key it would ask you for
  117. a file name to write the buffer to.  Be careful, it will overwrite an
  118. existing file without telling you so.
  119.  
  120. There is a variable, SCROLLLINES, that can be set to a number in the
  121. range 0-409.  This is used to specify the size of the received data
  122. buffer in lines.  Of course, I don't suggest you use 0 or anything
  123. less than 20 or so.  I don't know what happens if you make it too
  124. small.  The default is 300.  Why 409?  That is because the maximum
  125. buffer size is 32768 and 32768/80 is about 409.
  126.  
  127. I have added an automatic feature.  It was intended to be a way
  128. to automatically send CQ or call someone, but it can be used for
  129. other things.  If you assign the function "auto" to a key,
  130. when you press that key you will be prompted for a another key
  131. press.  Press the key that you want to automatically resend.
  132. For instance,  if you want to call CQ until someone answers,
  133. Press ALT-A (if you have "!KEY_ALT_A auto" in your simp.ini file)
  134. and you will see a window pop up with these three lines:
  135.     Press the key you want executed every NNN seconds
  136.     Press the ENTER key to change the time from NNN seconds
  137.     Press the SPACE bar to cancel");
  138. The NNN will be replaced with the AUTOTIME variable.
  139.  
  140. Now press the ALT-C (again, assuming that the ALT-C key has been
  141. assigned to a macro string that calls CQ for you) and the window
  142. should go away, the CQ should be sent and resent at the specified
  143. intervals.  If you hit the enter key you will be prompted for a
  144. new interval.  The default interval is set with the AUTOTIME line in
  145. the simp.ini.  Here is a snippet of a typical simp.ini file to 
  146. demonstrate the automatic feature.
  147.  
  148. AUTOTIME 90
  149. KEY_ALT_C ^Mx^M\
  150. cq cq cq de k4gvo^M\
  151. cq cq cq de k4gvo^M\
  152. cq cq cq de k4gvo at %t k^M^M^D
  153. !KEY_ALT_A auto
  154.  
  155. The "x" and the "^D" in the above macro are the commands to the 
  156. AEA PK-232 and PK-900 to start transmitting and to stop transmitting
  157. respectively.  If your tnc has different commands, you will obviously
  158. have to change them.  The time is specified in seconds.  Since 
  159. the program has no way of knowing when the transmitter has actually
  160. shut off, there is no way of assuring that you don't resend the
  161. CQ 3 seconds after finishing.  Be sure to make the time delay sufficiently
  162. long in order to have time to listen for a reply.
  163.  
  164. The automatic operation is shutdown as soon as any key is depressed on
  165. the keyboard (other than the CTRL, ALT, SHIFT etc. keys) or a mouse
  166. button is depressed.  There is one exception, if you press the same key
  167. that you are automatically re-executing, it won't stop.  When you are
  168. in automatic operation, you will see a capital A in the first column of
  169. the status bar.
  170.  
  171. Some of you may want the delete key to work like the backspace key.  I 
  172. didn't spend enough time on Vaxes to get used to that, but obviously
  173. there are a lot of people that did, so there is a new variable named,
  174. DEL_EQ_BKSP that you can put in your init file to make the delete key
  175. behave just like the backspace, I hope.
  176.  
  177. Support for non-standard COM address ports and IRQs is now available.
  178. Two additional parameters have been added to the COM line in the init
  179. file.  The first one is the base address and the second one is the
  180. IRQ number.  These are optional fields.  If they aren't present, they
  181. will default to the standard for whatever com port you are using.
  182. If you want to specify the IRQ but not change the base address, use
  183. a -1 for the base address.  For instance, the following line lets me
  184. communicate via my non-standard COM4 port.
  185.  
  186. COM4,19200,8,N,1,-1,5
  187.  
  188. Normally COM4 would use irq 3 but since I have a COM2 defined as irq
  189. 3, I had to rewire the COM4 port as irq 5.  The base address didn't
  190. change from the normal COM4 address, so I used the -1 to tell the 
  191. program to use the default.  If you need to change this address you
  192. may either use a base 10 decimal number like 740 or use the c language
  193. hexidecimal notation and specify 0x2E4.  Most of the documentation
  194. lists these addresses in hex, so be sure to use the 0x to preface
  195. the address in those cases.  
  196.  
  197. There is now support for callsign lookup via either the QRZ or Amsoft 
  198. CD-ROMs.
  199.  
  200. Bugs fixed in 2.3
  201.  
  202. I can't remember and I didn't keep track.
  203.  
  204. Write if you have problems.
  205.  
  206. 73 de K4GVO
  207. Jim <k4gvo@america.net, jwl@cray.com> or (look me up in wp)(packet)
  208.  
  209.